package com.flower.service;

import com.flower.domain.vo.admin.analysis.ShopCategoryDistributionVO;
import com.flower.domain.vo.admin.analysis.ShopOrderStatusVO;
import com.flower.domain.vo.admin.analysis.ShopSalesTrendVO;
import com.flower.domain.vo.admin.analysis.ShopTopProductsVO;

/**
 * 店铺数据分析服务
 */
public interface ShopAnalysisService {

    /**
     * 获取店铺销售趋势
     * @param shopId 店铺ID
     * @param timeRange 时间范围：today, week, month, year
     * @return 销售趋势数据
     */
    ShopSalesTrendVO getShopSalesTrend(Integer shopId, String timeRange);

    /**
     * 获取店铺订单状态分布
     * @param shopId 店铺ID
     * @param timeRange 时间范围：today, week, month, year
     * @return 订单状态分布数据
     */
    ShopOrderStatusVO getShopOrderStatusDistribution(Integer shopId, String timeRange);

    /**
     * 获取店铺热销商品
     * @param shopId 店铺ID
     * @param timeRange 时间范围：today, week, month, year
     * @param limit 限制数量
     * @return 热销商品数据
     */
    ShopTopProductsVO getShopTopProducts(Integer shopId, String timeRange, Integer limit);

    /**
     * 获取店铺商品类别分布
     * @param shopId 店铺ID
     * @param timeRange 时间范围：today, week, month, year
     * @return 商品类别分布数据
     */
    ShopCategoryDistributionVO getShopCategoryDistribution(Integer shopId, String timeRange);
} 